<text>represents a QuickDraw colour value as three unsigned integers, each in the range [0 .. 65535], separated by commas: ΓÇ£r,g,bΓÇ¥, where r is the red component, g the green component, and b the blue component.</text>
</content>
<name></name>
<script></script>
</card>
card_11344.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>Four-byte ΓÇ£OSTypeΓÇ¥ codes are used heavily through the Macintosh system. Usually they consist of four printable characters, but this is not guaranteed. For this reason these externals support OSType values in two forms: either as a string of up to four literal characters (blank-padded at the end if fewer than four), or as a string of exactly eight hexadecimal digits. Values may be returned in either form, as four literal characters where possible, otherwise as eight hex digits.</text>
</content>
<name></name>
<script></script>
</card>
card_11607.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>converts a string of hex digits to an unsigned integer, where HexString is a string of up to 8 hex digits.The function result is the equivalent as an unsigned decimal integer.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610227</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(HexString)</text>
</content>
<name></name>
<script></script>
</card>
card_5189.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">hecks for the presence of a particular item type on the Clipboard, where ScrapType is the scrap item type as an </span><span class="style2">OSType</span><span class="style1">.The function returns true if an item of that type currently resides on the Clipboard, false otherwise.</span></text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609619</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(ScrapType)</text>
</content>
<name></name>
<script></script>
</card>
card_8610.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">ompares two </span><span class="style2">OSType</span><span class="style1"> values for equality, where OSType1 and OSType2 are the values to be compared.The function result is a boolean, true if they represent the same </span><span class="style2">OSType</span><span class="style1"> value, false if not.</span></text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610270</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(OSType1, OSType2)</text>
</content>
<name></name>
<script></script>
</card>
card_9182.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>constructs a repetition of a given string, where TheString is the string to repeat, and RepeatCount is the repetition count.The function result is the specified number of copies of TheString concatenated together.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610332</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(TheString, RepeatCount)</text>
</content>
<name></name>
<script></script>
</card>
card_7573.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>converts a string into a HyperTalk expression which evaluates to that string, where TheString is the string value to quote.The function result is TheString with tab characters replaced with the HyperTalk constant ΓÇ£tabΓÇ¥, return characters with ΓÇ£returnΓÇ¥, and double quotes with ΓÇ£quoteΓÇ¥, with sequences of other characters bracketed by quotes, all combined with ΓÇ£&ΓÇ¥ operators so that, if evaluated as a HyperTalk expression, the result is the original string. If TheString is empty, the function result is the single word ΓÇ£emptyΓÇ¥.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610141</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(TheString)</text>
</content>
<name></name>
<script></script>
</card>
card_6043.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>returns the version of QuickDraw on this machine.The function result is a real number representing the version number of QuickDraw. A value of 0 indicates black-and-white QuickDraw, 1 indicates 8-bit Color QuickDraw, while 2.0 or greater indicates 32-bit QuickDraw. A negative number indicates an error (which shouldnΓÇÖt occur).</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609887</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>()</text>
</content>
<content>
<layer>background</layer>
<id>12</id>
<highlight> <true /> </highlight>
</content>
<name></name>
<script></script>
</card>
card_12013.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">uts an item on the scrap, where Length is the length in bytes of the data, TheType is the </span><span class="style2">OSType</span><span class="style1"> code for the data type, and Source is a pointer to the data.</span></text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>Length, TheType, Source</text>
</content>
<name></name>
<script></script>
</card>
card_5881.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>provides access to the SFPutFile routine in the Standard File package, where Prompt is the prompt string to display, and OrigName is the optional initial pathname (the volume/folder part is used to determine the initial folder displayed, while the filename part is used for the initial contents of the filename field).The function result is the fully-qualified pathname as chosen by the user, or the empty string if the user clicked Cancel.The sole reason for having this XFCN, instead of using the ΓÇ£ask fileΓÇ¥ command in HyperCard 2.0/2.1, is to give access to the System 7 enhanced putfile dialog,with its button for creating a new folder.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610792</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Prompt, [OrigName])</text>
</content>
<name></name>
<script></script>
</card>
card_2922.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>allows the creation and use of a pop-up menu (with submenus) from HyperCard, where MainMenu is a list of the text items comprising the top-level menu (any syntax understood by the AppendMenu toolbox call is acceptable), Top and Left determine, in global coordinates, the position of the menu on the screen, and PopUpItem is the number of the item to appear at that position.Additional menus may be specified as subMenu1, subMenu2 and so on up to a maximum of subMenu9. You specify a menu item that is to invoke a sub-menu by using a special form for the itemΓÇÖs ΓÇ£command-key shortcutΓÇ¥: command-1 means invoke subMenu1, command-2 means invoke subMenu2, and so on up to command-9. The command-key specifications are removed from the menus and replaced with links to the corresponding sub-menus.The function result consists of either a single number, or two numbers separated by a comma. In the case of a selection from the top-level menu, the main menu item ID is returned as a single number. If no valid selection was made, a single zero is returned. If a selection was made from a sub-menu, the number of the sub-menu (1 to 9) is returned, followed by a comma, followed by the item ID within the sub-menu.</text>
<text>returns the appropriate ordering for the lines in a given string, where Lines is a number of lines of data.The function returns an equal number of lines, with a number on each line, being the number of the line in Lines which should go in that position so that the lines are in ascending order.</text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610687</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Lines)</text>
</content>
<name></name>
<script></script>
</card>
card_8764.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>signals the user to bring HyperCard to the foreground under MultiFinder. If HyperCard is in the background, it will pause execution and its icon will flash in the menu bar until the user brings it to the front. Otherwise, it does nothing.</text>
</content>
<content>
<layer>background</layer>
<id>7</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610296</text>
</content>
<name></name>
<script></script>
</card>
card_5400.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">ists components of a given type registered with the Component Manager, where ComponentType is the </span><span class="style2">OSType</span><span class="style1"> component type code.The function result is a string containing one line for each compressor found; the first four characters of the line are the component subtype, and the rest of the line consists of the component name string.</span></text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609709</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(ComponentType)</text>
</content>
<name></name>
<script></script>
</card>
card_9347.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>computes the least common multiple of a set of integers, where N1, N2 and so on are up to sixteen unsigned integers to work out the multiple of.The function result is their least common multiple.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<name></name>
<script></script>
</card>
card_8149.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>converts an unsigned integer to a string of hex digits, where Value is the unsigned decimal integer to convert, and NrDigits is the number of hex digits to produce.The function result is a string of that number of digits.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610598</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value, NrDigits)</text>
</content>
<name></name>
<script></script>
</card>
card_12257.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">ets an item from the scrap, where DestHandle is a handle to a block in which to place the returned data (it will be resized as appropriate), and TheType is the </span><span class="style2">OSType</span><span class="style1"> code for the scrap item to return.On success, the function result will contain two lines: * the length in bytes of the returned data * the offset of the item within the scrap.</span></text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(DestHandle, TheType)</text>
</content>
<name></name>
<script></script>
</card>
card_3906.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>provides an interface from HyperTalk to the SFGetFile routine in the standard file package, where ΓÇ£Types1ΓÇ¥ and ΓÇ£Types2ΓÇ¥ (if present) are string whose lengths must be multiples of 4; each group of four characters represents an acceptable file type for files to appear in the display; a null string means that all types are acceptable. ΓÇ£OldNameΓÇ¥ is an optional previously-selected full path name; the context for file lookups is set to the same folder on the same disk before invoking SFGetFile.If ΓÇ£Types2ΓÇ¥, ΓÇ£CheckBoxNameΓÇ¥ and ΓÇ£SenseΓÇ¥ are present, the initial list of displayed file types is given by ΓÇ£Types1ΓÇ¥. However, a check box is added to the GetFile dialog (with name ΓÇ£CheckBoxNameΓÇ¥) which the user can toggle to switch between ΓÇ£Types1ΓÇ¥ and ΓÇ£Types2ΓÇ¥. ΓÇ£SenseΓÇ¥ governs the sense (checked or not) of this check box when ΓÇ£Types1ΓÇ¥ is selected.The function returns the complete path name of the file, or the empty string if the user clicked ΓÇ£CancelΓÇ¥.</text>
<text><span class="style1">eturns version information from a Gestalt selector code, where Selector is an </span><span class="style2">OSType</span><span class="style1"> specifying the code. The value returned from passing this selector to Gestalt must be a version specifier in standard system format.On success, the function result will contain five items, being: * the major version number * the minor version number * the bug fix revision number * the stage code: 32 = development, 64 = alpha, 96 = beta, 128 = release * the prerelease revision number.</span></text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2808224090</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>12</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>1</id>
<text>GestaltVersion</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Selector)</text>
</content>
<name></name>
<script></script>
</card>
card_10182.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">eturns numeric version information from a Gestalt selector code, where Selector is an </span><span class="style2">OSType</span><span class="style1"> specifying a Gestalt selector code. The value returned from passing this selector to Gestalt must be a version number in BCD format.On success, the function result will be a real number representing the version.</span></text>
</content>
<name></name>
<script></script>
</card>
card_11069.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">eturns an integer value from a Gestalt selector code, where Selector is an </span><span class="style2">OSType</span><span class="style1"> specifying a Gestalt selector code. The value returned from passing this selector to Gestalt must be an unsigned integer.On success, the function result will be this integer value.</span></text>
</content>
<name></name>
<script></script>
</card>
card_9659.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>computes the greatest common divisor of a set of integers, where N1, N2 and so on are up to sixteen unsigned integers to work out the divisor of.The function result is their greatest common divisor.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<name></name>
<script></script>
</card>
card_5086.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text><span class="style1">eturns the type of a specified file, where TheFileName is the name of the file.On success, the result is the file type as an </span><span class="style2">OSType</span><span class="style1">.</span></text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609535</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>12</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(TheFileName)</text>
</content>
<name></name>
<script></script>
</card>
card_59556.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>lets the user choose one of the resources of a given type attached to the current stack, or to the stacks currently in use, where Type is the four-character resource type, Prompt is a prompt string to be displayed above the list, OKButton and CancelButton are the labels to use for the ΓÇ£OKΓÇ¥ and ΓÇ£CancelΓÇ¥ buttons on the selection dialog (to allow for use from different languages), ListHeight is how many items should be simultaneously visible in the list (governs its height), and OldChoice is the name of the initial choice to be highlighted (defaults to none). The function returns the name of the newly-chosen resource concatenated with its decimal ID and separated by a return, or the empty string if the user clicked the ΓÇ£CancelΓÇ¥ button.</text>
<text>puts up a one-dimensional scrolling list of arbitrary text items and lets the user choose one or more (at the callerΓÇÖs option). It then returns the indexes (from 1 upwards) of the selected items, the empty string if none were chosen, or a zero if the ΓÇ£NewΓÇ¥ button was clicked.Items is the list of items to choose, one to a line, Prompt is the prompt string to be displayed above the list, OKButton, CancelButton and NewButton are the labels to use for the ΓÇ£OKΓÇ¥, ΓÇ£CancelΓÇ¥ and (optional) ΓÇ£NewΓÇ¥ buttons on the selection dialog (to allow for use from different languages), ListHeight is how many items should be simultaneously visible in the list (governs its height), Multiple is true to allow multiple selections, false to disallow (defaults to true), and Initial is a list of indexes, one to a line, of items to be preselected (defaults to none).The function returns the indexes of the selected items, one to a line, an empty list if none were selected, or a single zero if ΓÇ£NewΓÇ¥ was clicked.</text>
<text><span class="style1">rings up the standard Color Picker dialog, letting the user choose a colour, where Prompt is a prompt string to display in the dialog, and InitialColor is the initial </span><span class="style2">RGBColor</span><span class="style1"> value to be shown.The function returns the new chosen </span><span class="style2">RGBColor</span><span class="style1">, or the empty string if the user clicked Cancel.</span></text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609432</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Prompt, InitialColor)</text>
</content>
<name></name>
<script></script>
</card>
card_7849.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>tests a bit in an unsigned integer, where Value is the unsigned integer value to examine, and Bit is the number of the bit to test ([0 .. 31]).The function result is a boolean, true if the specified bit is set, false if not.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610171</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value, Bit)</text>
</content>
<name></name>
<script></script>
</card>
card_7046.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>sets a list of bits in an unsigned integer, where Value is the unsigned integer value to start with, and Bit1 and so on are up to 15 bit numbers (each in the range [0 .. 31]) representing bits to be set.The function result is Value with these bits forced to 1.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610403</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value, Bit1[, Bit2 ...])</text>
</content>
<name></name>
<script></script>
</card>
card_6706.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>bit-ors a list of unsigned integers, where Value1 and so on are up to 16 unsigned integer values to be ored together.The function result is also an unsigned integer value.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609971</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value1[, Value2 ...])</text>
</content>
<name></name>
<script></script>
</card>
card_6349.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>returns the ones complement of a specified integer, where Value is the unsigned integer value to be complemented.The function result is also an unsigned integer value.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799609924</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value)</text>
</content>
<name></name>
<script></script>
</card>
card_7399.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>clears a list of bits in an unsigned integer, where Value is the unsigned integer value to start with, and Bit1 and so on are up to 15 bit numbers (each in the range [0 .. 31]) representing bits to be cleared.The function result is Value with these bits forced to zero.</text>
</content>
<content>
<layer>background</layer>
<id>6</id>
<highlight> <true /> </highlight>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>2799610020</text>
</content>
<content>
<layer>background</layer>
<id>2</id>
<text>(Value, Bit1[, Bit2 ...])</text>
</content>
<name></name>
<script></script>
</card>
card_6563.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
<text>bit-ands a list of unsigned integers, where Value1 and so on are up to 16 unsigned integer values to be anded together.The function result is also an unsigned integer value.</text>
